CV Screen Scope

UiPath.CV.Activities.CVScope

Initialise le moteur neuronal UiPath Computer Vision en effectuant une analyse de la fenêtre indiquée, et fournit une étendue pour toutes les activités suivantes de Computer Vision. L’activité vous permet de sélectionner le moteur OCR que vous souhaitez utiliser pour extraire le texte de l’application cible. Le moteur OCR utilisé par défaut pour cette activité est UiPath Screen OCR. Le moteur peut être modifié en remplaçant manuellement le moteur par défaut par celui de votre choix.

Remarque : si vous utilisez un déploiement Linux CV Server local, vous pouvez également utiliser le moteur UiPath Screen OCR avec cette activité.

Propriétés

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.
• DélaiAvant : délai (en millisecondes) avant que l’activité commence à effectuer des opérations. La valeur par défaut de ce champ est de 300 millisecondes.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• MéthodeCV : liste déroulante qui indique la méthode de détection que vous souhaitez utiliser avec cette activité. Par défaut, les options DétectionÉlément et OCR sont sélectionnées. Les options suivantes sont disponibles :

  • Aucune : utilise uniquement l’automatisation de l’image.
  • Détection d’éléments : utilise Computer Vision.
  • OCR : utilise l’OCR.
• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.
• Cible.Élément : cette propriété utilise la variable UiElement renvoyée par une autre activité. Elle ne peut pas être utilisée avec la propriété Sélecteur. Ce champ ne prend en charge que les variables UiElement.
• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément de l'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Délai d'attente (millisecondes) : indique le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes).

• Cible.AttendrePrêt : avant d’effectuer les actions, la propriété attend que la cible soit prête. Par défaut, ce champ est défini sur INTERACTIVE. Les options suivantes sont disponibles :

  • None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.
  • INTERACTIVE : attend que les éléments d’IU avec lesquels vous travaillez dans l’application cible existent avant d’exécuter l’action.

  • COMPLETE : attend le chargement de tous les éléments d’IU dans l’application cible avant l’exécution effective de l’action.

    Pour évaluer si une application est à l'état Interactif (Interactive) ou Terminé (Complete), les balises suivantes sont vérifiées :

  • Applications de bureau : un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. S'ils existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé. De plus, l’état Occupé doit être défini sur False.
  2. Autres : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé.
  • Applications SAP : ce processus vérifie d’abord la présence de la balise <wnd>, puis détecte si la session est occupée grâce à une API spécifique de SAP.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Serveur (synchronisé)

• ApiKey : clé API utilisée pour l'authentification auprès du serveur Computer Vision. Ce champ ne prend en charge que les chaînes ou les variables String. Cela est une propriété globale, partagée entre toutes les activités CV Screen Scope du workflow.

  Remarque : veuillez noter que la clé API n’est requise que lors de la connexion au serveur UiPath Automation Cloud. Vous pouvez trouver plus d’informations sur l’acquisition d’une clé ici.
  Remarque :La modification de la propriété CléAPI d’une activité d’étendue modifie la valeur de toutes les autres étendues du workflow en cours. Vous n’avez donc pas à le faire manuellement.
• URL : URL du serveur qui exécute le service Computer Vision. Par défaut, cette option est configurée sur https://cv.uipath.com/. Il s’agit d’une propriété globale, partagée entre toutes les activités CV Screen Scope du workflow.

• UtiliserLeServeurLocal : si cette case est cochée, le serveur local sera utilisé pour l’analyse. Pour utiliser le serveur local, le package UiPath.ComputerVision.LocalServer doit être installé.

  Remarque :

  Lorsque vous utilisez un déploiement de serveur sur site du modèle de réseau neuronal, pour vous y connecter avec les activités Computer Vision, vous devez remplacer la valeur de la propriété URL de l'activité CV Screen Scope par l'URL de votre serveur.

  Plus de détails sur la connexion au serveur sont disponibles ici.

Dans le corps de l’activité

L’application que vous souhaitez automatiser peut être indiquée à l’activité CV Screen Scope en utilisant le bouton Indiquer à l’écran (Indicate On Screen) dans le corps de l’activité. Après cela, une capture de l’écran que vous avez indiquée s’affiche dans le corps de l’activité.

Si vous indiquez plusieurs écrans lors de l’automatisation d’une application, vous pouvez passer d’un écran à l’autre en utilisant les boutons directionnels (<, >) pour vérifier facilement les écrans utilisés par l’activité.

Les écrans peuvent également être renommés en les sélectionnant dans la liste déroulante Nom de l’écran (Screen Name) et en cliquant sur le bouton .